home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / man / cat1 / animate.1 < prev    next >
Text File  |  1993-10-31  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. animate(1)         Geomview Module           animate(1)
  5.  
  6.  
  7. NAME
  8.        animate - animate a sequence of geomview    files
  9.  
  10. SYNOPSIS
  11.        animate [-w posx    posy] [-p] [-b]    [-s speed] [-o]    [-S script]
  12.            [-hide] [-f file1 file2 ... ]
  13.  
  14. DESCRIPTION
  15.        Animate    is  an    interactive  animation    tool specifically
  16.        designed    to be used with     Geomview.  It    provides  several
  17.        simple  animation  controls such    as looping, bouncing, and
  18.        single frame stepping, as well as adjustable  speed  play-
  19.        ing.  The  program  works by telling geomview to    read in    a
  20.        sequence    of geomview files and then  telling  geomview  to
  21.        display    each frame of the sequence in order. Animate runs
  22.        only on Silicon Graphics    machines.
  23.  
  24.        There are two methods that Animate provides for specifying
  25.        which  frames  one  wants  to  have  in the sequence being
  26.        viewed. The first method    is to enter  the  name    of  every
  27.        frame into the text input box and press return or click on
  28.        load. The name of each frame must correspond with the name
  29.        of a geomview file existing in the file system.
  30.  
  31.        EXAMPLES
  32.  
  33.           pict1 pict2 pict3    pict4
  34.           pict*
  35.           pic??
  36.  
  37.        The  second method of loading frames is to first    create an
  38.        animation script    file outside of    animate    and then load the
  39.        script in by typing its name in the input box and clicking
  40.        on the script button. The advantage of this method is that
  41.        you  can     more easily specify the exact order in    which you
  42.        want the    frames to be shown. The    format of the script file
  43.        is  a list of frame names each followed by a newline. Com-
  44.        ments prepended by a # sign are allowed.
  45.  
  46.        EXAMPLE SCRIPT FILE
  47.  
  48.           #    list of    frames for
  49.           #    my rotating cube movie
  50.           cube.02
  51.           cube.04
  52.           cube.03 #    get rid    of this    frame later
  53.           cube.01
  54.         .
  55.         .
  56.         .
  57.           cube.90
  58.  
  59.  
  60.        Loading    frames    into  memory  may  take     a  little  time,
  61.  
  62.  
  63.  
  64.               July 10, 1992                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. animate(1)         Geomview Module           animate(1)
  71.  
  72.  
  73.        especially  if each frame is a particularly large file. Be
  74.        sure the    machine    you're using  has  sufficient  memory  to
  75.        load  all the frames you    desire.    Once all frames    have been
  76.        loaded, an 'animate' object will    appear    in  the     geomview
  77.        object browser. It is now possible to begin animating.
  78.  
  79.        Scrolling  through  frames  can be accomplished in several
  80.        different ways.    The first, and most  obvious  way  is  by
  81.        'playing'  the  frames.    Clicking  on the play button will
  82.        cause animate to     begin    playing     through  the  frames  in
  83.        order,  starting     with  the first frame or whichever frame
  84.        has been    selected.  The corresponding name of  each  frame
  85.        being  shown  is     outlined  in  red. Clicking on    stop will
  86.        cause animate to    stop playing the frames.
  87.  
  88.        The speed at which frames are animated depends on the size
  89.        and complexity of the object in each frame. Thus    different
  90.        sequences can  have  considerably  different  top  playing
  91.        speeds.    If the sequence    is playing too quickly,    the speed
  92.        of play can be adjusted    to  be    slower    using  the  speed
  93.        slider.    Playing     slowly     through  the  frames can also be
  94.        accomplished by holding one of the two step buttons  down.
  95.        Also,  clicking    on  either  step button    will cause future
  96.        playing to go in    the same direction as that step.
  97.  
  98.        To provide further control on direction    and  sequence  of
  99.        play,  the  bounce and loop features may    be used. To enter
  100.        bounce mode, click on the bounce    button.     While animate is
  101.        in  bounce  mode,  whenever  the     first    or  last frame is
  102.        reached direction of  play  automatically  reverses.  This
  103.        allows  bouncing    back and forth between the frames at each
  104.        end of the sequence.
  105.  
  106.        Clicking    on loop    puts animate in    looping    mode. In  looping
  107.        mode  animate  only  shows frames from a    certain    subset of
  108.        all frames in the sequence. To specify  which  frames  you
  109.        want  included  in  this    subset,    you outline each frame by
  110.        clicking    on it or dragging across it. Being in both  loop-
  111.        ing and bouncing    mode simultaneously will cause animate to
  112.        bounce back and forth between the first and last    frames in
  113.        the subset of frames.
  114.  
  115.        Clicking     on  'once'  puts  animate in 'once' mode where    a
  116.        sequence    of frames is played through only one  time.  Upon
  117.        reaching     the  first  or     last  frame  (depending on which
  118.        direction you are going)    of a specified sequence, while in
  119.        this  mode,  animate will stop playing. Normal playing can
  120.        be resumed by clicking on 'once'    again  and  exiting  this
  121.        mode.
  122.  
  123.        The  info  button  will    bring  up a short menu containing
  124.        helpful hints for program usage.    Clicking on the    exit but-
  125.        ton will    cause the program to exit.
  126.  
  127.  
  128.  
  129.  
  130.               July 10, 1992                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. animate(1)         Geomview Module           animate(1)
  137.  
  138.  
  139. OPTIONS
  140.        -w posx posy
  141.           Set  the    initial     position  of  the animate window
  142.           where posx and posy are distances     in  pixels  from
  143.           the  lower  left    hand  corner of    the screen to the
  144.           lower left hand corner of    the animate window.
  145.  
  146.        -p     Start playing through the    frames    right  away  upon
  147.           startup.
  148.  
  149.        -b     Go into bounce mode upon startup.
  150.  
  151.        -s speed
  152.           Set  the    speed  of play upon startup. The value of
  153.           speed may    be an integer between  0  and  100  which
  154.           roughly  signifies  the  percentage  of top playing
  155.           speed.
  156.  
  157.        -o     Set  animation  to  play    through     only  once  upon
  158.           startup.
  159.  
  160.        -S script
  161.           Specify  name  of     script     containing filenames for
  162.           objects to be read in upon  startup.  Takes  prece-
  163.           dence over -f option if present.
  164.  
  165.        -hide  Makes animate invisible upon startup. *Warning* all
  166.           animate commands must be specified on  the  command
  167.           line when    this option is used since there    is no way
  168.           to access    the main window.
  169.  
  170.        -f file1    file2 ...
  171.           Specify names of files  containing  objects  to  be
  172.           read in upon startup.
  173.  
  174. BUGS
  175.        When  loading  sequences     one after another, geomview will
  176.        often not load a    sequence on the    first try. This    can often
  177.        be  remedied  by     telling animate to load the sequence yet
  178.        again.
  179.  
  180.  
  181. SEE ALSO
  182.        geomview(1) oogl(5)
  183.  
  184. AUTHOR
  185.        Daeron Meyer        email: daeron@geom.umn.edu
  186.        The Geometry Center    phone: (612) 626-8307
  187.        1300 South Second Street
  188.        Minneapolis, MN 55454
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.               July 10, 1992                3
  197.  
  198.  
  199.